home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / perl5 / I18N::Collate.z / I18N::Collate
Encoding:
Text File  |  2002-10-03  |  3.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))                                              IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      I18N::Collate - compare 8-bit scalar data according to the current locale
  10.  
  11.        ***
  12.  
  13.        WARNING: starting from the Perl version 5.003_06
  14.        the I18N::Collate interface for comparing 8-bit scalar data
  15.        according to the current locale
  16.  
  17.              HAS BEEN DEPRECATED
  18.  
  19.        That is, please do not use it anymore for any new applications
  20.        and please migrate the old applications away from it because its
  21.        functionality was integrated into the Perl core language in the
  22.        release 5.003_06.
  23.  
  24.        See the perllocale manual page for further information.
  25.  
  26.        ***
  27.  
  28.  
  29. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  30.          use I18N::Collate;
  31.          setlocale(LC_COLLATE, 'locale-of-your-choice');
  32.          $s1 = new I18N::Collate "scalar_data_1";
  33.          $s2 = new I18N::Collate "scalar_data_2";
  34.  
  35.  
  36. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  37.      This module provides you with objects that will collate according to your
  38.      national character set, provided that the POSIX _s_e_t_l_o_c_a_l_e() function is
  39.      supported on your system.
  40.  
  41.      You can compare $s1 and $s2 above with
  42.  
  43.          $s1 le $s2
  44.  
  45.      to extract the data itself, you'll need a dereference: $$s1
  46.  
  47.      This module uses _P_O_S_I_X::_s_e_t_l_o_c_a_l_e(). The basic collation conversion is
  48.      done by _s_t_r_x_f_r_m() which terminates at NUL characters being a decent C
  49.      routine.  _c_o_l_l_a_t_e__x_f_r_m() handles embedded NUL characters gracefully.
  50.  
  51.      The available locales depend on your operating system; try whether locale
  52.      -a shows them or man pages for "locale" or "nlsinfo" or the direct
  53.      approach ls /usr/lib/nls/loc or ls /usr/lib/nls or ls /usr/lib/locale.
  54.      Not all the locales that your vendor supports are necessarily installed:
  55.      please consult your operating system's documentation and possibly your
  56.      local system administration.  The locale names are probably something
  57.      like xx_XX.(ISO)?8859-N or xx_XX.(ISO)?8859N, for example fr_CH.ISO8859-1
  58.      is the Swiss (CH) variant of French (fr), ISO Latin (8859) 1 (-1) which
  59.      is the Western European character set.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))                                              IIII11118888NNNN::::::::CCCCoooollllllllaaaatttteeee((((3333))))
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         PPPPaaaaggggeeee 2222
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.